home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / biz / dbase / DBFtoMUIbase.readme < prev    next >
Text File  |  1999-03-02  |  7KB  |  201 lines
  1. Short:    Converts DBF file to MUIbase import file
  2. Author:   raresoft@rz.fh-augsburg.de (Ralph Reuchlein)
  3. Uploader: raresoft@rz.fh-augsburg.de (Ralph Reuchlein)
  4. Version:  1.0
  5. Type:     biz/dbase
  6. Requires: MUIbase 1.0 or higher
  7. Kurz:     Wandelt DBF-Datei in MUIbase-Importdatei um
  8.  
  9.  
  10.                             DBF to MUIbase
  11.                             ==============
  12.  
  13.  
  14. PURPOSE
  15.  
  16.    MUIbase, a powerful relational programmable database that uses MUI
  17.    as user interface, only has a simple import feature.  Import and
  18.    export is done by reading and writing ASCII files.  Therefore the
  19.    data you want to import must be in a special format described in
  20.    the MUIbase documentation.  This format is very simple, but it
  21.    needs a lot of time to convert a database file format to this one.
  22.  
  23.    Since dBASE provides the most used database format on all
  24.    platforms, I wrote a small utility to convert these files into
  25.    MUIbase import files.  The dBASE file (short: DBF) uses a simple
  26.    format, but has some restrictions.
  27.  
  28.    This program is not only for use with MUIbase.  Every program, that
  29.    handles ASCII database files with field and record delimiters, can
  30.    progress files generated by DBFtoMUIbase.
  31.  
  32.    DBFtoMUIbase is EMAILWARE.  If you like it, send me a eMail
  33.    (address see end of ReadMe).
  34.  
  35.  
  36.  
  37. INSTALL
  38.  
  39.    Simply unpack the archive to anywhere you want.
  40.  
  41.  
  42.  
  43. REQUIREMENTS
  44.  
  45.    - MUIbase 1.0 or higher
  46.  
  47.  
  48.  
  49. USAGE
  50.  
  51.    DBFtoMUIbase is made for Shell usage.  Following string shows the
  52.    template:
  53.  
  54.         MUIBASEFILE=MBF/A/K,DBFFILE=DBF/A/K,NOQUOTES/S,
  55.         RECORDDELIMITER=RD/K,FIELDDELIMITER=FD/K,FIELDS/S,
  56.         LIMIT/K/N
  57.  
  58.    MUIBASEFILE=MBF/A/K
  59.       This option specifies the name of the MUIbase import file to be
  60.       generated.  This file will be overwritten without request.
  61.  
  62.    DBFFILE=DBF/A/K
  63.       The option DBF specifies the name of the DBF file to be
  64.       converted.  Currently the converter only handles DBF files of
  65.       version 3 and files without an additional DBT file.
  66.  
  67.    NOQUOTES/S
  68.       By default DBFtoMUIbase always surrounds the field names and
  69.       field data by double quotes.  When using this option you can
  70.       supress quoting.  If you do so, you have to switch off the
  71.       option 'double quotes' in the import requester.
  72.  
  73.    RECORDDELIMITER=RD/K
  74.       By default the converter uses the 'new line' character for
  75.       delimiting the records.  The option RD allowes you to set other
  76.       record delimiters.  The delimiter is a simple character or a
  77.       C-style escape character like '\n' or '\t' (\x??  and \o???  are
  78.       not allowed).  You also have to use the same character in the
  79.       import requester.
  80.  
  81.    FIELDDELIMITER=FD/K
  82.       By default the converter uses the comma character for delimiting
  83.       the fields in each record.  The option FD allowes you to set
  84.       other field delimiters.  The delimiter is a simple character or
  85.       a C-style escape character like '\n' or '\t' (\x??  and \o???
  86.       are not allowed).  You also have to use the same character in
  87.       the import requester.
  88.  
  89.    FIELDS/S
  90.       In MUIbase you only can import data when you provide a field
  91.       names line which *MUST* contain exactly the field names as used
  92.       in MUIbase.  This option prints the field names with type and
  93.       size from the DBF file, but does no conversion.  Using these
  94.       informations you have to build a table in MUIbase which contain
  95.       the printed same names (case sensitive!), types and sizes.  The
  96.       order of the fields is important too.
  97.  
  98.    LIMIT/K/N
  99.       For testing purposes you can limit the records writing to MBF
  100.       file.  If you specify a number which is less than the number of
  101.       records in the DBF file, the converter only writes as much
  102.       records as specified here.  It will always use the first records
  103.       in file.  A value of 0 is also possible; this only generates a
  104.       line of field names using the field and record delimiters.
  105.  
  106.  
  107.  
  108. NOTES
  109.  
  110.    Concerning MUIbase, DBF files have some restrictions as follows:
  111.  
  112.    · Field names are limited to 10 characters.
  113.    · Duplicated field names are not explicitly excluded.  This problem
  114.      can be corrected by manually editing the concerning field names.
  115.    · Memo fields are stored in a separate file with extension DBT
  116.      (additionally to the DBF one).  The converter does not handle
  117.      these files and sets such fields to NIL.  Try to change the memo
  118.      field in the application writing the DBF file to a character
  119.      field.
  120.    · Texts containing double quotes will not be handled correctly.
  121.      MUIbase then will terminate the import.  To solve this problem,
  122.      you manually have to correct such strings, so that the double
  123.      quotes are really the beginning and end of a string.
  124.  
  125.  
  126.  
  127. EXAMPLES
  128.  
  129.    Following converts a video database file 'video.dbf' to a MUIbase
  130.    import file 'video.import':
  131.       DBFtoMUIbase DBF=video.dbf MBF=video.import
  132.  
  133.    Same files, but without quotes:
  134.       DBFtoMUIbase DBF=video.dbf MBF=video.import NOQUOTES
  135.  
  136.    Same files, but using tabulators instead of commas:
  137.       DBFtoMUIbase DBF=video.dbf MBF=video.import FD=\t
  138.  
  139.    Next one shows the format of the DBF fields:
  140.       DBFtoMUIbase DBF=video.dbf MBF=video.import FIELDS
  141.    (unfortunately you also have to provide the option MBF; it only
  142.    generates a empty file)
  143.  
  144.    Generates only a line of field names in 'video.import':
  145.       DBFtoMUIbase DBF=video.dbf MBF=video.import LIMIT=0
  146.  
  147.  
  148.  
  149. DISCLAIMER
  150.  
  151.    THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS"
  152.    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  153.    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  154.    PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR
  155.    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  156.    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  157.    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  158.    USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  159.    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  160.    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  161.    OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  162.    SUCH DAMAGE.
  163.  
  164.  
  165.  
  166. MISC
  167.  
  168.    This program is written in 4 hours, so suggestions and bug reports
  169.    always are welcome, but I believe that the purpose of this program
  170.    is fully accomplished.  The conversion from MUIbase export files to
  171.    DBF files is difficult, because MUIbase doesn't provide field
  172.    formats ;-(
  173.  
  174.    Of course, watch the official MUIbase homepage at
  175.         http://www.amigaworld.com/support/muibase/index.html
  176.  
  177.    BTW: Register MUIbase! RESISTANCE IS FUTILE!
  178.  
  179.  
  180.  
  181. CONTACT
  182.  
  183.    snail  Ralph Reuchlein
  184.    mail:  Eibseestr. 18c
  185.           86163 Augsburg
  186.           GERMANY
  187.    
  188.    eMail: raresoft@rz.fh-augsburg.de (valid until end of July, 1999)
  189.    WWW:   rr.home.pages.de
  190.    IRC:   RRipley on #germany
  191.  
  192.  
  193. ============================= Archive contents =============================
  194.  
  195. Original  Packed Ratio    Date     Time    Name
  196. -------- ------- ----- --------- --------  -------------
  197.    15960   10154 36.3% 14-Feb-99 17:17:34  DBFtoMUIbase
  198.     6939    2909 58.0% 14-Feb-99 18:06:20  DBFtoMUIbase.readme
  199. -------- ------- ----- --------- --------
  200.    22899   13063 42.9% 15-Feb-99 20:49:22   2 files
  201.